home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
matchm10.zip
/
MATCHMKR.DOC
< prev
next >
Wrap
Text File
|
1992-07-08
|
25KB
|
639 lines
MATCH MAKER DOOR VERSION 1.00
July 07, 1992
PGP Communications
Copyright 1992
Support BBS - The DUNGEON BBS
(416)926-8734
SysOp Operation
Page 2
Table Of Contents
License Agreement................................................3
Introduction.....................................................4
Minimum Requirements.............................................5
Installation and SetUp...........................................6
Sysop SetUp and Functions.......................................12
Maintenance Utility - MM-UTIL.EXE...............................13
Notes...........................................................15
Page 3
ALL RIGHTS RESERVED by PGP Communications, Inc. (tm)
This legal document is an agreement between you, the end user, and PGP
Communications. BY USING THIS SOFTWARE, YOU ARE IN AGREEING TO BECOME
BOUND BY THE TERMS OF THIS AGREEMENT.
While every precaution has been taken in the preparation of this manual,
PGP Communications, Inc. (tm) assumes no responsibility for errors or
omissions. Neither is any liability assumed for damages resulting from
the use of the information contained herein.
PGP Communications retains the Copyright to this program. You are NOT
allowed to make changes to the compiled .EXE files without the expressed
written consent of PGP Communications. You are allowed to freely copy and
distribute this program as long as the original files which existed in the
archived file are distributed in their entirty with no additions. No fees
may be charged for distribution, other than a nominal fee of up to $5.00
for media expenses. You also agree NOT to disclose your registration
number, if and when aquired, to any other person(s) who(m) may use this
program.
PGP Communications, including but not limited to: INVOICE.EXE,
IN_MAIN.EXE, INVDEMO.EXE, MATCHMKR.EXE, CLASSAD.EXE and any other
program that is distributed under the PGP logo is/are
trademarked/copyrighted by PGP Communications, Inc.(tm)
PGP Communications assumes no liability for the use of this program,
and any SysOp using it takes and assumes all liability and respons-
ibility for it use and the damage that might occure through or during
it's use.
GAP, GAPUTI & GAPQBDR - are tradenames, trademarks and copyrighted
works of GAP Communications Development
BRUN45 & BRUN45.EXE - are tradenames, trademarks and copyrighted
works of MicroSoft Development
Page 4
Introduction
^^^^^^^^^^^^
Welcome to MATCHMKR(c) - VERSION 1.00!
The MATCHMKR Door allows callers to answer up to 73 questions that you
create pertaining to their likes and dislikes, and then to have the
door compare their answers to answers given by other callers. It then
reports back to the caller those other callers they match to and at
what percentage.
Matches are based on:
1st. Caller's sex
2nd. Caller's sexual preference.
3rd. on the 73 questions
The door allows the user to use his/her FIRST or LAST name as their
handle inside. So, if you have the door set up in a Forum that allows
handles and have your board configured to use the handles in the
DOOR.SYS file, aliases will be used; otherwise, the users REAL first
or last name is used.
The following files should be included in the file: MATCHMxx.ZIP
MATCHMKR.EXE -* The main door program
MATCH-1.CFG -* example config file for GAP (Node 1)
MATCH-2.CFG - example config file for second node GAP
MM-UTIL.EXE -* Door utility program
WELCOME -* example of the WELCOME file ascii
WELCOMEG -* example of the WELCOME file ansi
QUEST.DAT -* example question file
NEWS -* sample News file
BRUN45.EXE -* required to run the program
MATCHMKR.DOC - this file
REGISTER.DOC - registration form
-* means a required file and must be in the same
subdir as the door program
Page 5
Minimum Requirements
^^^^^^^^^^^^^^^^^^^^
You will need to have at least 256K of ram.
The door has file sharing set up and will require that SHARE.EXE is
loaded, even if you are not running two or more nodes, not running on
a network, nor running DDos or any other multi-tasker.
You may add the following command line to your AUTOEXEC.BAT FILE:
SHARE
If you are running in NON-GRAPHICS mode, you MUST have ANSI.SYS
installed as a device driver in your CONFIG.SYS file:
Example: DEVICE=ANSI.SYS
Page 6
Installation and SetUp
^^^^^^^^^^^^^^^^^^^^^^
First you will need to create a subdir where all the MATCHMxx.ZIP
files will be located. You may do this at a DOS prompt.
On The DUNGEON BBS, all door subdir's are located in the subdir
\GAP\DOORS. The command to create the MATCHMKR subdir would look like
this:
C>MKDIR \GAP\DOORS\MATCHMKR <enter>
Once you have created the subdir you will need to move your MATCHMKR
file into it. You may do this by using the DOS COPY command at a DOS
prompt. The command line would look something like this:
C>COPY A:*.* C:\GAP\DOORS\MATCHMKR <enter>
Once you have copied all the files, you will now need to run the
MM-UTIL.EXE program. This should be run within the MATCHMKR subdir.
You will need to change to that directory and may do so by entering
the following command at a DOS prompt:
C>CD \GAP\DOORS\MATCHMKR <enter>
In attempts to save you needed disk space, both MM-UTIL.EXE and
MATCHMKR.EXE require access to the run-time library BRUN45.EXE. In my
experience, I have found that programs need to think that the run-time
library is in the current directory. This is somewhat unfeasible,
since you certainly don't want to have copies of BRUNxx.EXE floating
around all over. I have found it workable to place all the libraries
that you need in one directory and append the directory. For example,
I have all of the library files in the directory C:\GAP\LIB. To
append this directory into the path so that any program needing access
to it will be able to load it, you would have the following commands
in your AUTOEXEC.BAT file:
APPEND /E
APPEND C:\GAP\LIB
With this, any program needing any of the files in this directory will
be able to access them, thinking that they're in the current directory.
Door programs written with the GAPQBDR Door Interface Module will run
on GAP Communications version 4 and greater and on PCB version 14 and
greater. However, at this time MATCHMxx only recognizes GAP and the
DOOR.SYS file. If you are running a different BBS software program,
you will need to utilize one of the many door conversion programs to
use MATCHMxx. I will be working on making this program PCBoard
friendly in the next release.
To configure the door for a particular BBS setup, a configuration file
must be used. The configuration file for MATCHMxx consists of 11
lines. The name of the file is usually the same as that of the door
program, but with a .CNF extension. The format of the file is as
follows:
Page 7
Installation and SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
C:\GAP <- path to BBS
The DUNGEON BBS <- your BBS name
0 <- must remain 0 for GAP
00000 <- registration number
you STUD <- used by the Match Maker
Horny Studs in several prompts
C:\PCRELAY <- full path to UTI driver
C:\GAP\DOORS\MATCHMKR <- full path to work directory
0 <- Forum number in which to import
0 <- bell toggle 1=on 0=off
1 <- match variance
The first line is the full path to your BBS default directory. For
GAP, this is usually C:\GAP.
The second line is the name of your BBS.
The third line is a flag that tells GAPQBDR what BBS system it is
running under. A 0 means GAP, and a 1 means PCB. At present, this
number NEEDS to remain 0.
The fourth line is your registration number. If you have not registered
your copy, this line should remain 00000.
The fifth line is used in the Match Maker prompt when a user attempts
to make a match. For example with the above line, the prompt would
be:
"Hiya USERNAME, you STUD! You have the Match Maker."
The sixth line is used in the opening screen when the Match Maker tells the
user how many people are in the database. For example, with the above line
the prompt would be:
"< 10 Horny Studs in the database >"
The seventh line is the path to GAP's UTI driver. This is needed as the
Match Maker will post a message in the Forum of your choosing each time
mail is left for them in the door.
The eighth line is the path to the Match Maker's work directory. This can
be the same as the directory the door program resides in.
The ninth line is the Forum number you wish the Match Maker to use for
importing its messages to.
The tenth line is the bell toggle. If you wish the system bell to sound if
a user pages you while inside the door, set this to 1. 0 will disable the
bell. Your original system setting will be restored when the user exits
the door.
The last line is the match variance. Normally this would be 1, however,
you may find that using 1.5 will help the user's match percentage, thus
not leaving them lonely. The door will differentiate between the users
Page 8
Installation and SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
sex and sexual preference, however, it would be difficult to have a user
respond to a description of themselves and then what they're looking for
and exactly match these responses ... namely because I've got no idea
what your question file is going to look like, or where what questions will
be placed. The long and the short of this is, that when a user has the
Match Maker match 'em up, they may only show a percentage match of, say
39%, but when looking at the questionnaire responses, actually be more
compatible than that. So, using a variance of 1.5 would probably raise that
percentage to about 65%. You'll have to play with this one and see what
best works for you and your users.
(How's that for being long winded!!)
GAPQBDR will obtain the sysop's name from the BBS configuration file.
Next, you will need to run the MM-UTIL.EXE program by entering the
following command at a DOS prompt:
C>MM-UTIL DOOR.CNF <enter>
**SEE NOTE AT THE END OF THIS FILE**
One of your created configuration files needs to be passed to MM-UTIL.EXE
as a command line parameter. The program uses this file to determine
if your copy of the door program is registered.
You will be presented with a menu of options. The first thing you
will need to do, is create the MATCHMKR working files. To do this,
choose menu option "1". The program will create the following files:
USERS.DAT - User file
MSGS.DAT - Mail message base
MSGS.IDX - Mail message base index
USERLOG - User log
Once this is done, you can exit the utility program by simply pressing
<ENTER> at the command prompt.
Now, you can continue installing the door by working on the other
files.
You must now create a batch file to invoke the door. This batch file
is placed in your BBS default directory. Such a batch file might look
like this:
@ECHO OFF
CD \GAP\DOORS\MATCHMKR
MATCHMKR MATCH.CNF
CD \GAP
gap <-Not needed for GAP versions above 4.xx
As you can see, the door is invoked by passing the configuration file
name as a parameter.
Page 9
Installation ans SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You will also need to modify your doors menu files and the data file
that tells the BBS what your doors are and the security level needed
to access them. For GAP, these are respectively:
DOORM
DOORMG
DOORS.DAT
Please refer to your BBS documentation for details on setting these
files up.
If you are running multi-nodes, simply create a separate door configuration
file for each node, and number them. For instance, for a 3 node
system, you might have the following configuration files:
MATCH-1.CNF
MATCH-2.CNF
MATCH-3.CNF
The only difference between the three would be the 1st line which
points to the default directory for the particular node.
Multi-user operation is automatic. For GAP, the presence of DUMMYLOK.DAT
in the MAIN directory triggers multi-user operation.
The following files are read during door initialization. They must be
present or the door will not operate.
DOOR.SYS
GAPBBS.CNF
In addition, this door program accesses the GAP USERS.DAT file for
information, but does not write to it. You also need to have a copy of
your GAPUTI.CNF file in the directory where the door resides. See the UTI
documentation to see how this is set up.
You will now want to set up the WELCOME and NEWS files. Samples of
these files have been included in this ZIP file. The WELCOME file is
shown to callers after they successfully log-on to the door. The NEWS
file is displayed immediately after this. Each of these files can
have an ASCII and a ANSI version. For instance, the ASCII welcome
file would be named WELCOME; the ANSI version would have a G appended
to the end of the name i.e WELCOMEG.
Next you will need to set up the QUEST file which will contain your
questions and answer choices. You may want to print out the QUEST.DAT
file to see an example of the set-up.
1) You may have up to 73 questions.
2) Each question can be up to 3 lines.
3) Each question can have up to 21 answers.
Page 10
Installation ans SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The following is an explanation of how to set up this file:
38 <- number of questions in this file
1 <- number of lines in the 1st question
10 <- number of answers
How old are you? <- question line 1
Less than 18 years old <- answer A
18 - 20 years old <- answer B
21 - 25 years old <- answer C
26 - 28 years old <- answer D
29 - 32 years old <- answer E
33 - 38 years old <- answer F
39 - 43 years old <- answer G
44 - 49 years old <- answer H
50 - 60 years old <- answer I
Over 60 years old <- answer J
2 <- number of lines in the last question
3 <- number of answers
Now honestly, did you tell the whole truth on the
questionnaire, and nothing but the truth so help you God?
Yes, I told the whole truth
A few lies never hurt anyone
I told mostly the truth
In the above example the first line is the total number of questions
contained in the file.
Line 2 is the number of lines in the first question.
Line 3 is the number of answers listed for the question.
Line 4 is the first question in the file.
Lines 5 to 13 are the answers for the first question.
The last 7 lines break down as follows:
Line 1 states that this question has two lines.
Line 2 states that there are 3 answers listed
Line 3 is the first line of the question.
Line 4 is the second line of the question.
Line 5 is the first answer.
Line 6 is the second answer.
Line 7 the third and last answer.
Remember that each question is displayed as the question lines plus a
blank line; the answer lines; plus a blank line and the prompt line.
If the total number of question lines + blank + answer lines + blank +
prompt line is greater than 22, you may end up with part of your
question scrolling off the caller's screen before they had a chance to
read it. So, keep it all within reason. The shorter the question,
the better. One liners are the best; two liners O.K, but three becomes
tedious and frustrating.
There are two questions you need not worry about including in the
file. These are:
Page 11
Installation ans SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
What is your Sex?
What is your sexual preference?
Since the program must have these to work correctly, they have been
included in the source code to eliminate problems.
Once you have created your QUEST.DAT file, you are finished with the door
install! Just be sure to test your questionnaire file before putting
the door up for callers to use. If you have problems, you may upload
your file to The DUNGEON BBS - (416)926-8734, and I'll do it for you.
Page 12
SysOp Set-Up and Functions
^^^^^^^^^^^^^^^^^^^^^^^^^^
The following sysop functions are available while awaiting keyboard
input:
F5 - Shell to DOS.
F8 - Twit user and return to BBS.
F10 - Initiate chat with user.
CF10 - Answer user page bell.
Home - Main user stats.
End - Displays sysop keys available.
PgDn - Secondary user stats.
Up Arrow - Increase user's time remaining.
Dn Arrow - Decrease user's time remaining.
One of the nicer features about using the TWIT key, is the user is not
told that "the sysop wants them to return to the BBS". Instead, a
very plain and simple message of "returning you to the BBS" is displayed
This way, the user is given no indication that the sysop is hovering
about.
When using the F5 shell to DOS key, to return to the door program,
simply type EXIT at the DOS command prompt. It is not necessary to
change directories back to the door directory. GAPQBDR is smart
enough to know which drive and directory the door program is in and
will reset the defaults upon return from DOS.
The Up and Down Arrow keys increase and decrease the user's time
respectively by 5 minutes for each key press. There is no indication
of what is occurring (except by the fact the user's time remaining
will change), so the sysop should try not to have a lead finger. The
increase or decrease is effective only while the user is in the door.
Page 13
The Match Maker Maintenance Program - MM-UTIL.EXE
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Included with MATCHMxx, is a utility maintenance program. This is a
handy program to help you maintain the files associated with this
door. The following outlines what this program will do for you.
When invoked, you will be presented with a menu of options:
[1] Create All Default Files
This command was discussed earlier and is used to create all default
files needed to run the door program. This command should only be
used to create the files from scratch, not in attempts to reset or
re-create them.
[2] Re-Create Main User File
This command is used to recreate the USER.DAT file. It will delete
your old file and create a new one.
[3] Re-Create Message Files
This command is used to recreate the MSGS.DAT and MSGS.IDX files. It
will delete your old files and create new ones.
[4] Re-Create User Log
This command is used to recreate the USERLOG file. It will delete
your old file and create a new one.
The difference between menu options 2 to 4 and menu option 1 is that
option 1 does not look for an existing file(s). So what will happen,
is that the start-up values will be changed, however all of the rest
of the information in the file will remain. Things would get quite
messy and you'd end up with lots of error messages. Of these, the
only command you will need to use on a regular basis is #4 to recreate
the USERLOG. This file will tend to grow quickly.
The bottom portion of the menu has the actual maintenance options.
[A] Message Base Utilities
When this is chosen, you will be presented with a sub-menu of choices.
[1] Show Message Headers
This command will list the message headers only; TO:, FROM:, MSG #,
DATE: of message and TIME: of message. If there are no messages yet,
you will be notified.
[2] Show Messages
This command will list all of the above, along with the entire message.
You will have one message per screen. Messages that have been re-
ceived will have a string of "****" in the TO field.
Page 14
The Match Maker Maintenance Program - MM-UTIL.EXE - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[3] Pack Message Base
This command will purge/pack and rebuild you message base files,
deleting any messages which have been received. The original files,
MSGS.DAT and MSGS.IDX, will be renamed MSGS.BAK and IDX.BAK,
respectively.
Just press ENTER at the command prompt to return to the main menu.
[B] Pack User File
With this command, you will be prompted for a date to use for the
purging of inactive users. The date format is MM-DD-YYYY. Any users
with a last log-on date before and including this date will be flagged
for deletion. Prior to the users being deleted, you will be presented
with a list of the affected users and asked if you wish to continue.
The old user file will be named USERS.OLD.
[C] Convert User File to Text
This command will convert the USERS.DAT file into a text file which
will list the users REAL name as listed in the BBS's user file, the
handle and account number used in the door and the last date and time
the user was in the door.
In the next release, I will incorporate the use of command line
parameters so that you can use this utility program in an event.
Page 15
**NOTE**
This version of Match Maker is a DEMO. The door program itself is not
crippled in any way. However, the utility program will not be fully
functional until you have registered the door. Until registration,
you will only be able to use the utility program to create the default
files.
This is released "As Is" and there is *NO* warranty or guarantee that
it will work for you and not cause any problems. You have chosen to
use this door, YOU are responsible for any unfortunate problems that
may develop from its use or misuse. I will gladly listen to any
suggestions or problems you may have, and I will do my best to fix
whatever needs to be fixed. I can not be held responsible for any
problems you may have, whether directly or indirectly due to the use
of the door.
Please read REGISTER.DOC for information on how you can register
your copy of Match Maker.
For complete support, contact the SYSOP on The DUNGEON BBS.
Registered users of any PGP Communications program will be given a
complementary user account on the BBS and free minor upgrades as they
become available.
Happy Exploring!
Peter Paulekat
The DUNGEON BBS
(416)926-8734 1200/2400 Baud